home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat2 / standard / getmountid.z / getmountid
Encoding:
Text File  |  1998-10-20  |  4.8 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ggggeeeettttmmmmoooouuuunnnnttttiiiidddd((((2222))))                                                    ggggeeeettttmmmmoooouuuunnnnttttiiiidddd((((2222))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _gggg_eeee_tttt_mmmm_oooo_uuuu_nnnn_tttt_iiii_dddd - get filesystem mount identifier
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_mmmm_oooo_uuuu_nnnn_tttt_...._hhhh_>>>>
  13.  
  14.      _iiii_nnnn_tttt _gggg_eeee_tttt_mmmm_oooo_uuuu_nnnn_tttt_iiii_dddd _((((_cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_pppp_aaaa_tttt_hhhh_,,,, _mmmm_oooo_uuuu_nnnn_tttt_iiii_dddd______tttt _****_bbbb_uuuu_ffff_))))_;;;;
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      _gggg_eeee_tttt_mmmm_oooo_uuuu_nnnn_tttt_iiii_dddd returns an identifier for the filesystem containing the file
  18.      named by _pppp_aaaa_tttt_hhhh.  Read, write, or execute permission for the named file is
  19.      not required, but all directories listed in the path name leading to the
  20.      file must be searchable.  _bbbb_uuuu_ffff is a pointer to a mountid structure that is
  21.      filled by the system call.
  22.  
  23.      The identifier returned is guaranteed to be unique for the mounted
  24.      filesystem within the running system, except for autofs's lofs
  25.      filesystems. The identifier is not guaranteed to be unique across
  26.      systems, and it is not guaranteed to persist across reboots or even
  27.      across mounts of the given filesystem. The identifier returned by lofs
  28.      filesystems is that of the mounted filesystem that lofs is providing
  29.      access to via a loopback mount. Therefore, for lofs filesystems the
  30.      combination of getmountid and lstat's st_rdev must be used to identify
  31.      uniqueness.
  32.  
  33.      _gggg_eeee_tttt_mmmm_oooo_uuuu_nnnn_tttt_iiii_dddd fails if one or more of the following are true:
  34.  
  35.      _EEEE_AAAA_CCCC_CCCC_EEEE_SSSS         Search permission is denied on a component of the path
  36.                     prefix.
  37.  
  38.      _EEEE_FFFF_AAAA_UUUU_LLLL_TTTT         _p_a_t_h or _b_u_f points outside the process's allocated address
  39.                     space.
  40.  
  41.      _EEEE_IIII_NNNN_TTTT_RRRR          A signal was caught during _gggg_eeee_tttt_mmmm_oooo_uuuu_nnnn_tttt_iiii_dddd execution.
  42.  
  43.      _EEEE_IIII_OOOO            An I/O error occurred while reading the file system.
  44.  
  45.      _EEEE_LLLL_OOOO_OOOO_PPPP          Too many symbolic links were encountered in translating
  46.                     _p_a_t_h.
  47.  
  48.      _EEEE_NNNN_AAAA_MMMM_EEEE_TTTT_OOOO_OOOO_LLLL_OOOO_NNNN_GGGG   The length of a _p_a_t_h component exceeds {_NNNN_AAAA_MMMM_EEEE______MMMM_AAAA_XXXX}
  49.                     characters, or the length of _p_a_t_h exceeds {_PPPP_AAAA_TTTT_HHHH______MMMM_AAAA_XXXX}
  50.                     characters.
  51.  
  52.      _EEEE_NNNN_OOOO_EEEE_NNNN_TTTT         Either a component of the path prefix or the file referred
  53.                     to by _p_a_t_h does not exist.
  54.  
  55.      _EEEE_NNNN_OOOO_LLLL_IIII_NNNN_KKKK        _p_a_t_h points to a remote machine and the link to that
  56.                     machine is no longer active.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggeeeettttmmmmoooouuuunnnnttttiiiidddd((((2222))))                                                    ggggeeeettttmmmmoooouuuunnnnttttiiiidddd((((2222))))
  71.  
  72.  
  73.  
  74.      _EEEE_NNNN_OOOO_TTTT_DDDD_IIII_RRRR        A component of the path prefix of _p_a_t_h is not a directory.
  75.  
  76. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  77.      Upon successful completion a value of 0 is returned.  Otherwise, a value
  78.      of -1 is returned and _eeee_rrrr_rrrr_nnnn_oooo is set to indicate the error.
  79.  
  80. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  81.      _ssss_tttt_aaaa_tttt_vvvv_ffff_ssss(2)
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.